home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glpixelmap.z / glpixelmap
Encoding:
Text File  |  2002-10-03  |  21.1 KB  |  200 lines
  1.  
  2.  
  3.  
  4. ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppffffvvvv,,,, ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuuiiiivvvv,,,, ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuussssvvvv - set up pixel transfer maps
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppffffvvvv( GLenum _m_a_p,
  14.                         GLint _m_a_p_s_i_z_e,
  15.                         const GLfloat *_v_a_l_u_e_s )
  16.      void ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuuiiiivvvv( GLenum _m_a_p,
  17.                          GLint _m_a_p_s_i_z_e,
  18.                          const GLuint *_v_a_l_u_e_s )
  19.      void ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuussssvvvv( GLenum _m_a_p,
  20.                          GLint _m_a_p_s_i_z_e,
  21.                          const GLushort *_v_a_l_u_e_s )
  22.  
  23.  
  24. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  25.      _m_a_p      Specifies a symbolic map name.  Must be one of the following:
  26.               GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR,
  27.               GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA,
  28.               GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____RRRR____TTTTOOOO____RRRR, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____GGGG____TTTTOOOO____GGGG, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____BBBB____TTTTOOOO____BBBB,
  29.               or GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____AAAA____TTTTOOOO____AAAA.
  30.  
  31.      _m_a_p_s_i_z_e  Specifies the size of the map being defined.
  32.  
  33.      _v_a_l_u_e_s   Specifies an array of _m_a_p_s_i_z_e values.
  34.  
  35. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  36.      ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp sets up translation tables, or _m_a_p_s, used by ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss,
  37.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD,
  38.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss,
  39.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD,
  40.      ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, and ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD.  Additionally, if the
  41.      GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg subset is supported, the routines ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee,
  42.      ggggllllCCCCoooolllloooorrrrSSSSuuuubbbbTTTTaaaabbbblllleeee, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDD, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDD,
  43.      ggggllllHHHHiiiissssttttooooggggrrrraaaammmm, ggggllllMMMMiiiinnnnmmmmaaaaxxxx, and ggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDD.  Use of these maps is
  44.      described completely in the ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr reference page, and partly in
  45.      the reference pages for the pixel and texture image commands.  Only the
  46.      specification of the maps is described in this reference page.
  47.  
  48.      _m_a_p is a symbolic map name, indicating one of ten maps to set.  _m_a_p_s_i_z_e
  49.      specifies the number of entries in the map, and _v_a_l_u_e_s is a pointer to an
  50.      array of _m_a_p_s_i_z_e map values.
  51.  
  52.      The ten maps are as follows:
  53.  
  54.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII           Maps color indices to color indices.
  55.  
  56.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS           Maps stencil indices to stencil indices.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR           Maps color indices to red components.
  75.  
  76.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG           Maps color indices to green components.
  77.  
  78.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB           Maps color indices to blue components.
  79.  
  80.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA           Maps color indices to alpha components.
  81.  
  82.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____RRRR____TTTTOOOO____RRRR           Maps red components to red components.
  83.  
  84.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____GGGG____TTTTOOOO____GGGG           Maps green components to green components.
  85.  
  86.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____BBBB____TTTTOOOO____BBBB           Maps blue components to blue components.
  87.  
  88.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____AAAA____TTTTOOOO____AAAA           Maps alpha components to alpha components.
  89.  
  90.      The entries in a map can be specified as single-precision floating-point
  91.      numbers, unsigned short integers, or unsigned long integers.  Maps that
  92.      store color component values (all but GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII and
  93.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS) retain their values in floating-point format, with
  94.      unspecified mantissa and exponent sizes.  Floating-point values specified
  95.      by ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppffffvvvv are converted directly to the internal floating-point
  96.      format of these maps, then clamped to the range [0,1].  Unsigned integer
  97.      values specified by ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuussssvvvv and ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuuiiiivvvv are converted
  98.      linearly such that the largest representable integer maps to 1.0, and 0
  99.      maps to 0.0.
  100.  
  101.      Maps that store indices, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII and GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS,
  102.      retain their values in fixed-point format, with an unspecified number of
  103.      bits to the right of the binary point.  Floating-point values specified
  104.      by ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppffffvvvv are converted directly to the internal fixed-point format
  105.      of these maps.  Unsigned integer values specified by ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuussssvvvv and
  106.      ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuuiiiivvvv specify integer values, with all 0's to the right of the
  107.      binary point.
  108.  
  109.      The following table shows the initial sizes and values for each of the
  110.      maps.  Maps that are indexed by either color or stencil indices must have
  111.                 n
  112.      _m_a_p_s_i_z_e = 2  for some n or the results are undefined.  The maximum
  113.      allowable size for each map depends on the implementation and can be
  114.      determined by calling ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAXXXX____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____TTTTAAAABBBBLLLLEEEE.  The
  115.      single maximum applies to all maps; it is at least 32.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                                                         PPPPaaaaggggeeee 2222
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))
  138.  
  139.  
  140.  
  141. _____________________________________________________________________________________
  142. _m_a_p                    LLLLooooooookkkkuuuupppp IIIInnnnddddeeeexxxx     LLLLooooooookkkkuuuupppp VVVVaaaalllluuuueeee    IIIInnnniiiittttiiiiaaaallll SSSSiiiizzzzeeee   IIIInnnniiiittttiiiiaaaallll VVVVaaaalllluuuueeee
  143. ____________________________________________________________________________________
  144. GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII    color index      color index          1               0
  145. GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS   stencil index    stencil index         1               0
  146. GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR    color index           R               1               0
  147. GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG    color index           G               1               0
  148. GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB    color index           B               1               0
  149. GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA    color index           A               1               0
  150. GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____RRRR____TTTTOOOO____RRRR         R                R               1               0
  151. GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____GGGG____TTTTOOOO____GGGG         G                G               1               0
  152. GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____BBBB____TTTTOOOO____BBBB         B                B               1               0
  153. GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____AAAA____TTTTOOOO____AAAA         A                A               1               0
  154.  
  155.  
  156. EEEERRRRRRRROOOORRRRSSSS
  157.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_a_p is not an accepted value.
  158.  
  159.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _m_a_p_s_i_z_e is less than one or larger than
  160.      GGGGLLLL____MMMMAAAAXXXX____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____TTTTAAAABBBBLLLLEEEE.
  161.  
  162.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _m_a_p is GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII,
  163.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG,
  164.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB, or GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA, and _m_a_p_s_i_z_e is not a power
  165.      of two.
  166.  
  167.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp is executed between the
  168.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  169.  
  170. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  171.      ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaapppp
  172.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII____SSSSIIIIZZZZEEEE
  173.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS____SSSSIIIIZZZZEEEE
  174.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR____SSSSIIIIZZZZEEEE
  175.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG____SSSSIIIIZZZZEEEE
  176.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB____SSSSIIIIZZZZEEEE
  177.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA____SSSSIIIIZZZZEEEE
  178.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____RRRR____TTTTOOOO____RRRR____SSSSIIIIZZZZEEEE
  179.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____GGGG____TTTTOOOO____GGGG____SSSSIIIIZZZZEEEE
  180.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____BBBB____TTTTOOOO____BBBB____SSSSIIIIZZZZEEEE
  181.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____AAAA____TTTTOOOO____AAAA____SSSSIIIIZZZZEEEE
  182.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAXXXX____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____TTTTAAAABBBBLLLLEEEE
  183.  
  184.  
  185. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  186.      ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee, ggggllllCCCCoooolllloooorrrrSSSSuuuubbbbTTTTaaaabbbblllleeee, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDD,
  187.      ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDD, ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD,
  188.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllHHHHiiiissssttttooooggggrrrraaaammmm,
  189.      ggggllllMMMMiiiinnnnmmmmaaaaxxxx, ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee, ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr, ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss,
  190.      ggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD,
  191.      ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD
  192.  
  193.  
  194.  
  195.  
  196.                                                                         PPPPaaaaggggeeee 3333
  197.  
  198.  
  199.  
  200.